用户通过调用API来实现对系统服务的调用，所有API均为宏定义， 所有系统服务也为宏定义，所有API参数均支持宏定义。 更多...
CosyOS_用户API 的协作图:
|
模块 | |
| 任务 | |
| 定时中断 | |
| 由用户定时操作，当定时器溢出时，系统将自动恢复/调用与其绑定的任务/钩子并可自动重复定时。 | |
| 定时查询 | |
| 由用户定时操作，当定时器溢出后，系统在每个滴答周期都会查询用户定义的事件， 若事件为真，系统将自动恢复/调用与其绑定的任务/钩子并可自动重复定时。 | |
| 互斥信号量 | |
| 仅适用于在任务中对任务级公共资源的资源同步（互斥访问）。 | |
| 二值信号量 | |
| 二值信号量常用于事件同步、资源同步（互斥访问）。 | |
| 计数信号量 | |
| 计数信号量常用于事件同步、资源管理，是唯一能够实现并发事件同步的手段。 | |
| 飞信 | |
| 飞信是轻量型的、超高速的线程通信工具，其典型特征是“极简类型、极速通信”。 | |
| 消息邮箱 | |
| 消息队列 | |
| 消息队列是唯一能够实现并发消息同步的手段。 | |
| 事件标志组 | |
| 适用于对一类事件的、多对一关系的事件同步。 | |
| 全局变量访问 | |
| 由CosyOS内核提供服务支持，可实现在“任务、滴答、中断”中，对非原子全局变量 的安全访问，同时不会破坏零中断延迟。 | |
| 软件RTC | |
| 适用于没有硬件RTC的物联网设备。 | |
| 动态内存 | |
| 临界区 | |
| 杂项 | |
详细描述
用户通过调用API来实现对系统服务的调用，所有API均为宏定义， 所有系统服务也为宏定义，所有API参数均支持宏定义。
- API分类
- 创建API
静态创建：前缀为“u”，分为声明对象（uExtern）、创建对象（uCreate）、定义对象（uDef）。
动态创建：前缀为“d”，分为声明对象（dExtern）、创建对象（dCreate）。
- 任务API
前缀为“u”，指仅在任务中调用。
- 滴答API
前缀为“t”，指仅在系统滴答中断中调用，包括在滴答钩子、定时中断钩子、
定时查询钩子、定时查询事件等处调用。
- 中断API
前缀为“i”，指仅在用户中断中调用。
- PSVAPI
前缀为“p”，指仅在 pendsv_hook 中调用。
- 公共API
前缀为“x”，指可在任意处（任务、滴答、中断）调用。
- API返回
- 无返回
（1）服务的执行结果一定是成功的，所以不需要返回。
（2）所有中断挂起服务均无返回。
- 返回错误码
服务的执行结果可能会失败，导致失败的原因可能有多个。
（1）绿码：无错误。
（2）黄码：由于结果已经成功，导致本次并未执行。
（3）红码：失败。
- 返回结果
服务的执行结果可能会失败，但导致失败的原因是唯一的。
执行结果为 bool 类型，true 为成功，false 为失败。
- 返回指针
返回一个指针，(void *) 类型，NULL 为失败。
- 返回值
返回一个数值，特定的数据类型，0 为失败。
- 名词解释
- 无限阻塞
阻塞时间为无限长。
- 无限等待
超时时间为无限长。
- 无限延时
延时时间为无限长。
- 无限同步
仅同步一次，事件处理线程便可不限次数的周期运行。
仅二值信号量支持该功能，可通过上锁的方式来终止无限同步。
